home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / tests / pdevtest / pdevtest.man < prev    next >
Encoding:
Text File  |  1989-02-01  |  2.8 KB  |  83 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/lib/forms/RCS/proto.man,v 1.5 89/01/27 08:36:02 ouster Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS PDEVTEST cmds
  13. .BS
  14. .SH NAME
  15. pdevtest \- Test program for pseudo-devices
  16. .SH SYNOPSIS
  17. .nf
  18. \fBpdevtest\fR [\fIoptions\fR]
  19. .SH OPTIONS
  20. .IP "\fB\-S\fR" 14
  21. Run as a slave process.
  22. .IP "\fB\-M \fInumSlaves\fR" 14
  23. Run as the master of \fInumSlaves\fR.
  24. .IP "\fB\-o \fIoutFile\fR" 14
  25. Name of the output file.
  26. .IP "\fB\-p \fIpseudoDevice\fR" 14
  27. Name of the pseudo-device.
  28. .IP "\fB\-i\fR" 14
  29. Echo data to/from the pseudo-device using ioctl.
  30. .IP "\fB\-r\fR" 14
  31. Test reading from a pseudo-device.
  32. .IP "\fB\-w\fR" 14
  33. Test writing to a pseudo-device.
  34. .IP "\fB\-W\fR" 14
  35. Enable write-behind (use with \fB-M\fP).
  36. .IP "\fB\-s\fR" 14
  37. Use select, too.
  38. .IP "\fB\-c\fR" 14
  39. Fork the client process.
  40. .IP "\fB\-n \fInumReps\fR" 14
  41. Number of test repetitions.
  42. .IP "\fB\-d \fInumBytes\fR" 14
  43. Number of bytes to transfer.
  44. .IP "\fB\-P \fInumLoops\fR" 14
  45. Loop \fInumLoops\fP times before replying (with \fB-M\fP).
  46. .IP "\fB\-z\fR" 14
  47. Force Master to use select with 1 client.
  48. .IP "\fB\-b\fR" 14
  49. Test switching request buffers (use with \fB-M\fP).
  50. .IP "\fB\-x\fR" 14
  51. Turn off all tracing.
  52. .IP "\fB\-h\fR" 14
  53. Except leave histogram taking on (ok with \fB-x\fP).
  54. .BE
  55.  
  56. .SH DESCRIPTION
  57. .PP
  58. \fBpdevtest\fP is used to test various features of pseudo-devices.
  59. Several instances of the program are run for a single test.
  60. One master process (\fB-M\fP) is run first;
  61. it is the pseudo-device server.
  62. The master can enable write-behind (\fB-W\fP),
  63. pause before replying (\fB-P\fP),
  64. and switch request buffers (\fB-b\fP).
  65. Ordinarily if there is only one slave a slightly faster service
  66. loop is used to does not use select.
  67. The master process can be forced to use select even in this case with \fB-z\fP.
  68. After the master has started several slave (\fB-S\fP) processes are started.
  69. Each slave can do a different test (\fB-i -r -w\fP).
  70. The number of repetitions and the amount of data to transfer
  71. are specified with the \fB-n\fP and \fB-d\fP options.
  72. Additionally, a slave process can fork (\fB-c\fP) to test stream sharing,
  73. and use select (\fB-s\fP).
  74. .pp
  75. \fBpdevtest\fP generates output to the file specified by the \fB-o\fP option.
  76. It can also use a specific pseudo-device file (\fB-p\fP).
  77. Finally, system tracing can be turned off (\fB-x\fP),
  78. which makes the tests run faster.
  79.  
  80. .SH KEYWORDS
  81. pseudo-device, test
  82.  
  83.